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Introduction 


The Cromemco Resident Disk Operating System 
(RDOS) is a 1K-byte program supplied in ROM with 
each Cromemco model 4FDC disk controller card. 
The RDOS program is designed to execute beginning 
at location C000 in memory space. 


RDOS includes a_ bootstrap loader for the 
Cromemco Disk Operating System (CDOS) supplied 
with Cromemco disk software. RDOS also includes a 
system monitor with over a dozen commands. Several 
of the RDOS monitor commands are the same as those 
used in the Cromemco Z-80 Monitor program. These 
include commands to transfer program control, display 
the contents of memory, change the contents of 
memory, move and compare blocks of memory, write 
data to output ports, and change the baud rate of the 
seria] port on the 4FDC card. The RDOS monitor also 
has several unique commands designed specifically for 
disk operations. These include commands to select 
one of four disk drives, set the head seek rate, seek 
disk tracks, read blocks of data from the disk, and 
write blocks of data onto the disk. 


To use RDOS, first be sure that the power-on jump 
address of your ZPU card is set to memory location 
C000 (see Table 1). If you wish to boot in CDOS from 
your disk without entering the RDOS monitor, then 
set Switch 8 of the 4FDC card to the ON position (this 
selects auto-boot mode). Once CDOS is booted in, you 
may return to the RDOS monitor by executing the 
“BYE” command in CDOS. If on power-up or reset 
you do wish to enter the RDOS monitor, then set 
Switch 3 of the 4FDC card to the OFF position (see 
Table 2). Once the RDOS monitor is entered, you can 
begin using the RDOS commands described in this 
manual. 


Switch Position 


ZPU Switch 


Al15 
Al4 
Al3 
Al2 


Table 1 


The power-on jump address switch on the 
ZPU card should be set as shown to begin 
automatic execution of RDOS at location 
C000 in memory space. 


RDOS Mode 4FDC Switch 3 


ON 
OFF 


CDOS Bootstrap 
RDOS Monitor 


Table 2 


The setting of Switch 3 on the 4FDC card 
sets the RDOS mode of operation on 
power up. When this switch is ON, CDOS 
is automatically booted in from the system 
diskette. When this switch is OFF, the 
RDOS Monitor is entered. 


Command Format 


The normal prompt of the monitor is a semi-colon, 
‘>, However, if a disk drive is selected the prompt 
changes in order to remind the user which drive is 
current. (See Select Disk Drive for details.) 


The monitor is controlled by one and two-character 
commands from the terminal keyboard. The format 
is free-form with respect to spaces. All data is entered 
and printed in hexadecimal format. 


In the following, DM is the Display Memory 
command and S is the Swath operator (see below). The 
four examples are equivalent commands. They display 
the contents of 100 hex bytes of memory beginning 
with location 1000 hex. (‘(CR)’ indicates carriage 
return). , 


3DM1000 10FF (CR) 
3DM1000S100 (CR) 
; DM 1000 10FF (CR) 
; DM 1000 S 100 (CR) 


When entering an address as an operand, only the 
last four digits typed in are retained. For example, 
‘321000’ is read as ‘1000’. Therefore, if a wrong digit 
is entered, continue typing until the last four digits are 
correct. 


Only the last two digits typed are retained when a 
two-digit number such as a data byte is entered. 


Swath Operator 


There are two ways to specify the address range 
of many commands. The first is to simply list the 
beginning and ending addresses (and, where appropriate, 
the destination address). For example, the first 
command displays the contents of memory 
between addresses E400 and E402. The second com- 
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mand moves (or copies) the first 1400 hex bytes of 
memory to memory starting at 2000 hex. 


DM E400 E402 
M O 13FF 2000 


Another way to do the same thing is to use the 
Swath operator, S, to specify the width of the address 
range rather than state the ending address explicitly. 


DM E40083 
M 0O $1400 2000 


Errors and Escapes 


When the monitor detects an error condition, the 
command is aborted and a ‘?’ is printed followed by 
the prompt ‘;’ for the next command. 


Any command may be aborted from the keyboard 
either when the monitor is requesting further input, 
or during print-out, by depressing either of the ESCAPE 
or the ALT MODE key. (CONTROL-SEMI-COLON, 
CONTROL-SHIFT-‘K’, and ‘} ’ may also work, depend- 
ing on the design of your CRT terminal.) 


Baud Rate Selection 


When the monitor is entered, push carriage-return 
(up to four times) until the monitor responds with: 


CROMEMCO- RDOS 
The monitor is capable of selecting 19200, 9600, 
4800, 2400, 1200, 300, 150, or 110 baud. The max- 


imum number of carriage-returns required to select any 
of these baud rates is four. 


The baud rate can also be changed by using 
Initialize command. (See page 3.) 

Some peripheral devices such as paper tape readers 
or punches may have no keyboards. The baud rate 
can also be set by outputting a data byte from the 
following table to port 0. 


Baud Rates 


110 
150 
300 
1200 
2400 
4800 
9600 


Data Byte 


The baud rate can be octupled by outputting 10 hex 
to port 2. Outputting 0 to this port brings the baud 
rate back to normal. 


System Stack 


The RDOS stack normally resides in low memory 
between 40 and 80 hex. However, if it is in the way, it 
can be moved using the Kick Stack command. (See 
page 3.) 


Using the RDOS Monitor 


Set the power-on jump switch on the ZPU card to 
C (1100 binary) and turn off DIP switch 3 on the 
AFDC. 


Depress carriage-return two to four times in order 
to set the UART on the 4FDC to the baud rate of the 
terminal being used. 


The monitor will then respond: 
CROMEMCO RDOS 


followed by a prompt ‘;’. The monitor is then ready 
to accept commands from the keyboard. 


Commands 


Boot 


(1) B (CR) 


Boots CDOS from the diskette on drive-A. CDOS 
will then respond with its prompt ‘A.’. 


Display Memory 


(2a) DM beginning-addr ending-addr (CR) 
or 
(2b) DM beginning-addr S swath-width 


The contents of memory are displayed in hexa- 
decimal form. Each line of the display is preceded by 
the address of its first byte. For example: 


;DM100 $3 
0100: C3 34 7F 


Examine Input Port 


(3)  Eport-number (CR) 


Displays the current contents of the input port 
identified by port-number (in hex). 


G starting-addr (CR) 
Execution begins at starting-address. 


wv 


>) 


oa 


RDO 


Og? 4 
Initialize Baud Rate 
(5) I (CR) 

After the carriage-return is typed, change the baud 
rate of the terminal to the desired value and then push 


carriage-return until the monitor responds with its 
prompt. 

The monitor is capable of selecting 19200, 9600, 
4800, 2400, 1200, 300, 150, or 110 baud. The max- 
imum number of carriage returns required to select 
any of these baud rates is four. 


Kick Stack 


(6) Knew-stack-location (CR) 


Moves the monitor’s stack from normal location 
at 7C hex to any convenient location in RAM 
memory. Remember to leave 64 (40 hex) bytes for 
the system stack above its new location (including 
4 bytes for temporary storage above the stack proper). 


Move 
> 


(7a) M source-addr source-end destination-addr (CR) 


or 
(7b) M source-addr Sswath-width destination-addr(CR) 


Move (or copy) the contents of memory beginning 
with source-address and ending with source-end to 
destination-address. After the move, the monitor 
verifies that source and destination are the same. 
This will result in a print-out of discrepancies which 
are not really errors after certain types of overlapping 
moves. However, this print-out can be terminated by 
depressing ESCAPE or ALT Mode. 


The move command can be used to fill a block of 
memory with a constant. For example, to enter zeros 
between locations 100 and 108, use the Substitute 
Memory command to enter 0 at location.100, and 
then move 100 through 107 to 101: 


M100 107 101 
or 
M100S 8 101 


Care should be taken not to overwrite the monitor’s 
stack which resides in low memory between 40 and 
80 hex unless changed with the Kick Stack command. 


Output 


(8)  O data-byte port-number (CR) 


Writes data to the output port identified by port- 
number (in hex). 


(9a) RD _ destination-addr destination-end _ sector- 
number (CR) 
or 

(9b) RD _ destination-addr S swath-width | sector- 


number (CR) 


Before this command will be accepted the disk 
drive and track number must have been specified. 
(See the Select Disk Drive and Seek commands.) 


This command reads enough sectors from the 
current drive to fill the specified memory area, starting 
with the specified sector of the current track. The 
first track and sector and the last track and sector read 
are then displayed. However, if the last sector of 
the last track on the diskette is read before the 
memory area is filled then a question mark is printed 
and the command is terminated. The track and sector 
designations for both 5” and 8” diskettes are shown 
in Table 3. 


The command is also terminated if an error occurs 
in reading a sector. In this case, a message of the 
following type is printed: 


R-ERR nn 
where nn is a hex number which indicates the status: 


Indication 


Not Ready 
Record Type 
Record Type 


2 
or 


Record Not Found 
CRC Error 

Lost Data 

Data Request 
Busy 


oF Nw UDA ~} 


The number of the last track accessed can be 
obtained from input port 31 hex and the number of 
the last sector accessed from input port 32 hex. (See 
the Examine Input Port command.) 


8” Diskette 


0-4C hex 
1-1A hex 


5” Diskette 


0-27 hex 
1-12 hex 


Tracks 
Sectors 


Table 3 


Care should be taken not to overwrite the 
monitor’s stack which normally resides in lower RAM 
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between 40 and 80 hex. If it is desired to load this 
region of memory from the disk, first move the stack 
using the Kick Stack command. 


Seek Track 


(10) S track-number (CR) 


Before this command will be accepted the disk 
drive must be specified. (See the Select Disk Drive 
command.) 


This command seeks the specified track of the 
current drive. 


If an error is made, a message of the following type 
is printed: 
S-ERR nn 
where nn is a hex number which indicates the status: 


Indication 


Not Ready 
Write Protect 
Head Engaged 
Seek Error 
CRC Error 
Track O 

Index 

Busy 


Ce nwhua ~~ 


Substitute Memory 


(11) SM address (CR) 


Substitute Memory displays the contents of 
address and outputs a dot, ‘.’, as a prompt for the 
substituted value. If no change is desired, type a 
space or another dot. Otherwise, enter the new value. 
The monitor accepts hex digits until it gets a delimiter, 
such as a space, dot, or carriage-return, retaining the 
last two digits entered as the value. Unless the delim- 
iter is a carriage-return, the monitor then outputs the 
contents of the next sequential memory location with 
a dot prompt. A  carriage-return terminates the 
command. 


Verify 


(12a) V source-addr source-end destination-addr (CR) 
or 
(12b) Vsource-addr S swath-width destination-addr (CR) 


This command verifies that the block of memory 
between source-address and source-end contains the 


same values as the block beginning at destination- 
address. The addresses and contents are printed for 
each discrepancy found (unless the print-out is 
terminated by ESCAPE or ALT MODE). 


This command works by reading bytes from the 
source and destination and comparing them. If a 
discrepancy is found, the memory is read again for 
print-out. Thus it can happen that a discrepancy is 
printed-out with the source and destination contents 
indicated to be the same. This is caused by a defective 
memory element. 


e Ld 
Write Disk 
(18a) WD source-addr source-end sector-number (CR) 


or 
(18b) WD source S swath-width sector-number (CR) 


Before this command will be accepted the disk 
drive and track number must have been specified. 
(See the Select Disk Drive and Seek commands). 


This command writes the contents of the specified 
memory area to the current drive, starting with the 
specified sector of the current track. The first track 
and sector and the last track and sector written are 
then displayed (see Table 3). However, if part of the 
memory area remains after the last sector of the last 
track is written, a question mark is printed and the 
command is terminated. 


The command is also terminated if an error is made 
in writing a sector. In this case, a message of the 
following type is made: 


W-ERR nn 
where nn is a hex number indicating the status: 


ee 
cr 


Indication 


Not Ready 

Write Protect 
Write Fault 
Record Not Found 
CRC Error 

Lost Data 

Data Request 
Busy 


7 
6 
5 
4 
3 
2 
1 
0 


w 


The last track accessed can be obtained from port wd) 


31 hex. The last sector accessed from port 32 hex. (See 
Examine Input command.) 
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Select Disk Drive 


The 4FDC will control up to four disk drives, 
labelled ‘‘A”’, “B’’, “C’’, and “D”. It can handle seek 
speeds from the slow seek appropriate to the mini 
floppy to the fast seek of Cromemco’s large floppy. It 
can also handle the medium seek of some other large 
floppies. To select a drive and a seek speed, type the 
drive label followed by one semi-colon for the fast 
seek, and two semi-colons for medium seek, or three 
semi-colons for slow seek. For example, to select 
drive C with slow seek, type: 


C333 (CR) 
To select drive A with fast seek, type: 
A; (CR) 


Until the drive selection is changed the normal 
monitor prompt, ‘;’, will be replaced by the disk label 
and speed indicator as typed, ‘C ; ; ;’ in the first 
example. 


All disk commands (Seek, Read Disk, and Write 
Disk) refer to the drive most recently selected. 


Disk selection also restores the disk drive head 
to home, track 0. If an error is made in doing this 
a message of the following type is printed: 


H-ERR nn 
where nn jis a hex number indicating the status: 


Indication 


Not Ready 
Write Protect 
Head Engaged 
Seek Error 
CRC Error 
Track 0 
Index 

Busy 


7 
6 
5 
4 
3 
2 
1 
0 
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An Illustrative Example 


. To illustrate a specific use of the RDOS commands, 
consider the situation where you wish to make a copy 
of a diskette. If you have two disk drives this can easily 
be done using the CDOS command XFER. But if you 
have only one disk drive, you can use RDOS to read 
the original diskette into memory, and then write from 
memory to the new diskette. Since the total amount 
of system RAM memory is typically less than the 
capacity of a diskette, the procedure will have to be 
repeated several times — a different portion of the 
diskette is copied with each iteration. 


The following procedure explains how to use RDOS 
to make a back-up mini-diskette using only one drive. 
This procedure assumes that there is 32K of contiguous 
low memory; if the user has less memory, the procedure 
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can easily be adapted to a smaller configuration by 
decreasing the swath lengths of the READS and 
WRITES. Note that you must also keep track of the 
sector numbers when changing the following procedure. 
This is easily done by noting the starting and stopping 
track and sector numbers given after the completion 
of a READ or WRITE. 


Throughout the following, note that the commands 
which are typed by the user are underlined. The other 
prompts and messages are those issued by RDOS. The 
messages enclosed in brackets are parenthetical 
remarks and should not be typed into the terminal. 


Get into RDOS and insert the disk to be copied, 
or the original disk, into the drive. Then type the 
following RDOS commands. 
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RDOS Program Listing 


0000 


CGO7U) 


(004) 


CO007) 
COONS) 
CHO04) 


(0030) 
C0030) 
C0032) 
C0083) 
C0034) 
C0024) 
(GOSd> 


C0003) 
C0000) 
C0004) 
€00409 
C0010) 
C0020) 


Cg000) 
CO0023 
C0002) 
(00709 
(0080) 


C0000) 


CO00M) 
COO0A) 
COOLED 
C007D) 


0002 
0003 
N00 4 
0005 
0006 
NO07 
0008 
0009 
OO10 
DOLL 
HOL2 
VOLS 
0014 
0015 
0014 
0017 
00183 
OA? 
0020 
0021 


we FASTSEEK 3 


0023 
0024 
V025 
0024 
0027 
0028 
N029 
0030 
O34 
0032 
0033 
0034 
0ON3%S 
0036 
0037 
0038 
0039 
0040 
OO41 
0042 
0043 
0044 
OO4S 
0046 
DOG 
0048 
0049 
0050 
OOS1 
OOS 


0054 


$ COPYRIGHT (0) Lory 
; 

ORG OOOOH 
3 
; 
STACK 3  EQU 7 CH 


DRIVES? EAU A 


BEIT ASSTGNMENT FOR THE 


> wr > z OF > > > > Gr O> Ge OD 


EQU 7 
DISKMODEs FQU a 

MAXKTS AW 4 

STHE DISK NUMBER C0 - 3) 
3 

$ 

DSTATS EO 
DCOMMND HEU 


OH 
30H 


DSEC 3 EQU oak 
DOATAZ  IFQU A 


DF LAGS 3 
DCONTHE 3 
DTRACK § 


Ea 34e 
IF QU 34H 
EGU SAH 
> 
TMASKS EQU 6) 
BAUD 3 QU Q 
PARLEL $ EQU 4 
BOOTSW?2 EAU 40H 
MAXIMS  EQU LOW 
HDLIDM? EQU e0H 
; 

STAT $ 
DATA S 
COMMNID 3 
DAV? 


ECL 0 
QU af 
EQU a 
EQU 
EAU 


> 
CAGE § EQU 0 
3 


ECL) 


$ OD 
3 EAU 


NAH 


23 EQ LEH 
ALT FQU FD 
; 


CROMEMCO » 


NC. 


SSTART OF FROM 


SMUST LEAVE ROOM FIR 

eA BYTES OF TEMP STORAGE 

SABOVE THE STACK 

3 (STACK > F DISK FLAGS 

I CSTACK+L) = DISK LETTER CA DD 
PCSTACKAZY — CSOTACKAS) 2 ROOM FOR 
3 TO 2 SEMI-COLONS AS FART OF 
ITHE DISK FROME T. 


SMAX. NO. OF DISK DRIVES 


DISK FLAGS 


OCCURTES BITS 0 8 Ft 


IRISK STATUS FORT 

sDXGK COMMAND FORT 

IDIESK SECTOR PORT 
{ DATA FORT 

iK FLAGS FORT 

IDISK CONTROL PORT 

IDIESK TRACK FORT 


SINTERRUPT MASK FORT 
7RAUD RATE PORT 

SP ARALL EL, eT 
eEOOT SWITCH 

SMAGK FOR MAXX DISK 
7HEAD LOAD MASK 


sSTATUS PORT 

IDATA FORT 

SCOMMAND FORT 
FDATA-AVATLABLE MASK 
SXMIUTTER--BUF--EME TY MSK 
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C000 ZA7C00 
CO03 
COO4 
COOS FY 
C006 CDEECO 
C009 97 
COOA D303 
COOC 
(0 0F: 
Coi0 
C012 COORCL 


COLS 
COOLS CD29C2 


COS 

COLES BEDO 
COLA D330 
COLC DESO 
COLE LF 
COLF SFE 
O21 FR 
CO22 BELO 
C024 

COZ4 215000 
Ca2Z7 FO 
Ca2h FS 
CO29 44 
COZA CD3SFCO 
CA2D 200K 
COE FL 
COBO FS 
COB) 44 
C032 LEOL 
034 CRSceod 
C037 CAB000 
CO3A FL 
CORE EELO 
CO3D 1S8ES 


DAS7 
0938 
chihwiry 
0040 
0061 
9062 
0063 
0064 
90065 
0066 
0067 
06468 
vn69 
9070 
0077 
0072 
0073 
007 

007% 
0074 
OO77 
0078 
0079 
0080 
0081 
0A2 
0083 
0064 
0085 
0086 
0087 
0088 
goa 
0090 
QOS 
0092 
0093 
0094 
O09 
0094 
0097 
0098 
0099 
0100 
OLOL 


0102 
0103 
0104 
0105 
0106 
0107 
0108 
0109 
0110 
O12 
OL1L2 
0113 
O11 4 
OLLS 
O11 
OLL7. 
0118 


; 
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BOOTMC 3 
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CO3F 


COA 
O44 
CO 45 
C048 
CO4A 
CO4e 
COVE 
CO5B 


COSe 


COSA 
COs 
COS5 
COSA 
COSC 
COSE 
COSF 
C0460 
C42 
C064 
C066 
COs 


CO6A 
CA46A 


caVée 
CO4C 
COSE 
CO6F 
O74 
CO7 4h 
O73 
CO74t 
CO7S 
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co7s 
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co7e 
CO7F 
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AND 
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07783 PRESERVES ALL 
OF 79 

a O70 PNM aa) Ay Crh.) 

1808 O73. whe PE xX 
0782 
N07 83 
0784 
O76 
QF BSG 
OF 87 

Leck COEF CAL NF OR GNA MALL SR ACE 
OFB9 3 

70 N7?0 FNAL? 1.0 Ay 

OD Ee O79 1 ¢ 02 aa Pee x 

§ 71) AFR? 1D ryt. 

OPS 3 

O74 3 

O79 3 PRINT THE NUMIEE 

O7 9G ¢ 


; 
; 
0777 , PRINTS THE NUMIE 
3 
? 


PRINT THE NUMBER TN HL. 
PR GERVES ALL GUT Ae 


we > we Oe wr o> 
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